##############################################################################
###+-------------+############################################################
#+-| REPLICATE() |----------------------------------------------+#############
#| +-------------+ Produces a string that contains c_expression |#############
#|                 repeated repeat_count times                  |#############
#+--------------------------------------------------------------+#############
##############################################################################
##############################################################################
#+--| Summary |----------------+##############################################
#|     #INCLUDE string.hdr     |##############################################
#+-----------------------------+##############################################
##############################################################################
##############################################################################
#+--| Syntax |----------------------------------------------------------+#####
#|     FUNCTION CHAR replicate PROTOTYPE                                |#####
#|      PARAMETERS CONST CHAR c_expression, VALUE UINT repeat_count     |#####
#+----------------------------------------------------------------------+#####
##############################################################################
##############################################################################
#########+---| Description |----------------------------------------+#########
#########| The replicate() function produces a string that contains |#########
#########| c_expression repreated repeat_count times.  The maximum  |#########
#########| length of the returned string is 254 characters.         |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Make a string of '?' characters.                    |#########
#########|                                                          |#########
#########| ? replicate("?",80)                                      |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Put the "*" character after the amount              |#########
#########| *    when printing checks.                               |#########
#########|                                                          |#########
#########| ? replicate("*",50-len(check_total))                     |#########
#########+----------------------------------------------------------+#########
##############################################################################